home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / UTIL / OtherMenu 1.8.3 folder.sit / OtherMenu 1.8.3 folder / OtherMenu folder / OtherMenu Manual.rsrc / TEXT_1000_Main Manual.txt < prev    next >
Text File  |  1996-02-11  |  20KB  |  293 lines
  1.     
  2. OtherMenu Manual
  3.  
  4. ﾂｩ 1992窶“1995 by James W. Walker.
  5.  
  6. OtherMenu is an extension that creates a system-wide hierarchical menu somewhat similar to the Apple menu.  You can use it to launch applications and documents, perform various utility functions, and execute FKEYs.  In standard directory dialogs (Open and Save dialogs) you can use it to select files and folders.  It requires System 7, and is accelerated for PowerPC.
  7.  
  8. The first time you start your Mac with OtherMenu installed, OtherMenu creates a folder named OtherMenu Folder inside your System Folder.  You will see a menu whose title is a round icon near the help menu.  Initially, the menu will contain items named 窶彝ecent applications窶, 窶彝ecent documents窶, and 窶彝ecent folders窶, an item for each disk on the desktop, a dividing line, and finally 窶廾therMenu窶.  The last item has a submenu with three items: 窶廴anual窶, which displays this documentation, 窶弃references窶, which displays a dialog in which you can change various settings, and 窶廴emory Usage窶, which displays a dialog showing how much memory OtherMenu is using.
  9.  
  10.  
  11. Operation    
  12.  
  13. Release the mouse button over any menu item.  In most cases, the result is the same as if you had double-clicked the item in the Finder.  The exceptions are FKEYs, compiled AppleScript files, KeyQuencer macro files, and OtherMenu externals.  Finder doesn窶冲 know how to run these items, but OtherMenu does.
  14.  
  15. If you hold the option key as you release the mouse button over a menu item representing a folder, then the folder will not be opened, but it will be added to the 窶彝ecent folders窶 submenu.  This can be used to get temporary convenient access to a deeply nested folder.
  16.  
  17. As you are mousing through the menu, you can press and hold a certain key to get some information about an item.  I call this the 窶彿nstant info窶 feature.  (Initially the key will be 窶彿窶, but you can change it using the Preferences dialog.)  A little window pops up, showing the icon, type, creator, size, modification date, and path.  If the item is an alias, the information window displays information about the target of the alias, unless the alias points to something on a disk that is not mounted, or the alias cannot be resolved for some other reason.
  18.  
  19.  
  20. Configuring the Menu    
  21.  
  22. The contents of OtherMenu窶冱 menu is determined by the contents of the OtherMenu Folder, just as the contents of the Apple menu is determined by the contents of the Apple Menu Items folder.  All files and aliases placed in the OtherMenu Folder become OtherMenu menu items.  And unlike the Apple menu, you can insert folders, and aliases of folders and volumes, to create submenus up to 5 levels deep.
  23.  
  24. You can modify the order of menu items by adding special characters to the beginnings of their names.  The first ordinary character in the Macintosh character set, the space, is particularly useful.  I also like 笳Š, or shift-option-v, which comes very late in the order.  Do not begin a file name with a period.  To make a dividing line in the menu, create a folder with any name ending in 窶œ-***窶.
  25.  
  26. OtherMenu窶冱 menu will appear just as the contents of the OtherMenu Folder appear in 窶廸ame窶 view in Finder, alphabetically, by level.  For example, if the contents of the OtherMenu Folder look like this,
  27.  
  28. ﾂ 
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42. then the menu will look like this:
  43.  
  44. ﾂ 
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. The Preferences Dialog    
  63.  
  64. If you select 窶弃references窶 from the 窶廾therMenu窶 submenu, you will see a dialog that controls several settings.  Radio buttons near the right-hand side select five groups of settings, called 窶廨eneral窶, 窶廴enu窶, 窶弖olumes窶, 窶彝ecent窶, and 窶廡ont窶.
  65.  
  66.  
  67. General Preferences    
  68.  
  69. The 窶彜how startup icon窶 checkbox determines whether OtherMenu displays an icon during the startup process.
  70.  
  71. The 窶廾ff when At Ease but not Finder is running窶 option disables OtherMenu when At Ease is running (even in the background) but Finder is not running.
  72.  
  73. The 窶弩arn on launch in tight memory窶 option shows a warning dialog if you launch an application when there is not enough memory to give the application its preferred amount.  If this is not checked, the application may be launched in its minimum amount of memory without warning.
  74.  
  75. To set the key that triggers the 窶彿nstant info窶 feature, click on the rectangle to the right of 窶廬nstant info key:窶 and, while holding the mouse button, press a key.  You can use either a character key like 窶彿窶 or a modifier key like control.  However, it would not be a good idea to use the command or shift key for this purpose.
  76.  
  77.  
  78. Menu Preferences    
  79.  
  80. The 窶廴enus cached窶 control determines how many submenus will be cached; higher values get you speedier response at the expense of some system memory.  If you check the option to 窶忖pdate cache in background窶, then OtherMenu (with the help of OtherMenu AE Helper) will periodically make sure that the main menu and first level of submenus are up to date.  You may not want to use this feature if you have a hard disk driver that spins down the disk when inactive.  But in the case of a PowerBook, OtherMenu AE Helper ensures that the interval between updates is greater than the spin-down time.
  81.  
  82. The three radio buttons determine where the menu will appear: to the left of the help menu, just left of the application menu, or to the right of the application menu.  If you have other extensions that install system menus, their relative positions may depend upon the order in which the extensions load at startup time.
  83.  
  84. If you uncheck 窶廴enu title is an icon窶 then the menu title becomes 窶廾ther窶.  Changing this setting when the menu is at far right may cause some misalignment problems in the menu bar, which will be corrected by a restart.
  85.  
  86. By the way, if you would like the menu title to be a different icon, you can arrange that simply by giving OtherMenu a custom icon using the Finder.  The new icon will appear on the menu bar after restart.
  87.  
  88. The delay settings affect the behavior of submenus, and affect all software, not just OtherMenu.  The 窶彗ppearance delay窶 allows you to drag down a menu without submenus appearing and disappearing as you go past them.  The 窶彭isappearance delay窶 helps you drag diagonally from a menu item that owns a submenu to an item within the submenu, without the submenu disappearing.  These parameters are also affected by Carlos Weber窶冱 MenuTuner control panel, but OtherMenu maintains the new values actively instead of changing the standard values in PRAM.  The numbers are in units of  approximately 1/60 seconds.  Note that since the change takes effect immediately, you can try it out on the menu before dismissing the dialog.
  89.  
  90.  
  91. Volume Items Preferences    
  92.  
  93. OtherMenu can maintain menu items for volumes (floppies, CD-ROMs, hard disks, etc.) that are mounted on the desktop by creating and deleting aliases to each volume.  This feature may be turned on and off with the 窶廴aintain volume items窶 checkbox.
  94.  
  95. Below the label 窶弖olume items folder:窶, in smaller type, you should see either the path to a folder, or the words 窶œ(This folder has not been defined)窶.  Use the 窶彜et Folder窶 button to respecify this folder.  If you set this folder to be the OtherMenu Folder, then volumes items will appear in OtherMenu窶冱 main menu, as shown below.
  96.  
  97. ﾂ 
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111. To make a submenu of volumes, choose a subfolder of the OtherMenu Folder, like so:
  112.  
  113. ﾂ 
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127. You can specify a prefix of up to 4 characters that will be added to the names of all volume menu items, in order to group and position them in the menu.
  128.  
  129. Finally, there are checkboxes by which you can specify that volume items should be accumulated, rather than being automatically deleted when the volumes are unmounted.  (If there is an individual item that you wish to protect from automatic deletion, you can simply lock that alias using Finder or the File Info external.)
  130.  
  131.  
  132. Recent Items Preferences    
  133.  
  134. OtherMenu can maintain folders of aliases to recently used applications, folders, and documents.  This feature may be turned on and off with the 窶廴aintain recent items窶 checkbox.
  135.  
  136. More precisely, the recent applications folder records applications and desk accessories.  The recent documents folder records other files that have been opened using OtherMenu, or by double-clicking in the Finder, or by selection in a directory dialog.  A folder is recorded as a recent folder if you opened it using OtherMenu or if you selected a file inside it using a directory dialog.
  137.  
  138. Among the things not recorded as recent items are folders opened in the Finder, control panels opened in the Finder, applications in the Startup Items folder, and documents double-clicked in a THINK C or Metrowerks C project file.
  139.  
  140. You specify the names and locations of these folders using 窶彜et Folder窶 buttons, as in the case of the the volume items folder described above.  Unlike the volume items folder, you should not set the recent items folders equal to the OtherMenu Folder.  This is because recent items have no prefix to identify them.
  141.  
  142. Items chosen from OtherMenu窶冱 main menu will not be recent menu items because they are readily accessible.  You can choose the number of items you would like OtherMenu to maintain in each recent items folder with the 窶廴aximum recent items窶 control; up to 50 are allowed. You can have OtherMenu automatically delete all items from previous sessions with the 窶廚lear recent items at startup窶 checkbox.
  143.  
  144. If you use System 7.5, you may prefer to turn off OtherMenu窶冱 Recent Items feature and use the Recent Applications and Recent Documents folders supplied by Apple窶冱 software.  But note that you can put aliases to these folders into your Other menu, and then you can use these recent items within directory dialogs.
  145.  
  146.  
  147. Menu Font Preferences    
  148.  
  149. Using these pop-up menus, you can set the font used in OtherMenu窶冱 menu.  The size setting 0 means the standard size for the system font.  In U.S. systems, the system font is Chicago 12.
  150.  
  151. You can also assign a style, or combination of styles, to folders, aliases, or other files.  Note that an alias to a folder or disk counts as an alias, not as a folder.
  152.  
  153.  
  154. OtherMenu Externals    
  155.  
  156. OtherMenu has code modules, similar to FKEYs, of file type '*Cmd', '*CMD', or '*Sub'.  They use system memory and can be placed in the menu and executed with less overhead than applications.  '*Sub's have their own submenus, while the other types do not.  You need not install the full set of externals.  If you hold the shift key while selecting an external, it will display an About box, which can allow for adjustment of settings, or might just show the version number.  If you are a programmer, you can write your own externals.  Sample code is available as a separate 窶廾therMenu Developer Kit窶 from some of the same sources as OtherMenu, such as CompuServe and America Online.
  157.  
  158. See the Externals Manual for information on individual externals.
  159.  
  160.  
  161. About FKEYs    
  162.  
  163. An FKEY is a small program without a full user interface that performs a simple task and quits.  When you press command-shift-3 to take a screen snapshot, you are executing an FKEY installed in the System file.  You can place FKEY files, and aliases to FKEY files, in the OtherMenu Folder, and use the menu to execute them.  Such files should have file type 'FKEY', and contain exactly one resource of type 'FKEY', plus possibly resources of other types.
  164.  
  165.  
  166. AppleScript, KeyQuencer, and QuicKeys    
  167.  
  168. OtherMenu can be used to run compiled AppleScript documents, assuming that you have AppleScript installed.  If you hold down the shift key while selecting such a file, then it will be opened in the Script Editor instead.
  169.  
  170. OtherMenu can also run a KeyQuencer macro file, assuming you have KeyQuencer installed.  (When I say KeyQuencer macro file, I mean a text file created by the Macro Editor, not a macro file created by exporting macros from the KeyQuencer control panel.)  If you hold the shift key down while selecting such a file, it will be just as if you had double-clicked the file in the Finder: The macro Editor will open and run the macro.  Finally, if you hold the shift and command keys, the Macro Editor will open the file but not run it.
  171.  
  172. Conversely, if OtherMenu AE Helper is installed and running, one can use AppleScript to invoke OtherMenu:
  173.  
  174. tell application "OtherMenu AE Helper"
  175.   Open alias "Main:System Folder:OtherMenu Folder:Externals:Memory Map"
  176. end tell
  177.  
  178. Submenu-generating externals can be scripted with a slightly different syntax:
  179.  
  180. tell application "OtherMenu AE Helper"
  181.   Open alias "Main:System Folder:OtherMenu Folder:Externals:Paste Clips" menu item 2
  182. end tell
  183.  
  184. Similarly QuicKeys can send AppleEvents to OtherMenu AE Helper to tell OtherMenu to open an external or something else.  You may need to increase OtherMenu AE Helper窶冱 memory allocation with File Info to make this work.
  185.  
  186. It is also possible to use KeyQuencer to run OtherMenu externals, using the OMOpen extension that comes with KeyQuencer (versions 1.2 and later.)
  187.  
  188.  
  189. OtherMenu AE Helper    
  190.  
  191. OtherMenu AE Helper is a background-only application that serves several purposes:  It helps OtherMenu record double-clicked files as recent documents, it signals OtherMenu periodically when you turn on the option to update menus in the background, it talks to the Finder on behalf of the Finder Folders external, and it makes it possible to control OtherMenu with AppleScript.  Although it looks like an extension, lives in your Extensions folder, and does not appear in your application menu, it really is an application.  You can see its memory partition with the Memory Map external, and if necessary quit it with Memory Map or launch it with OtherMenu.
  192.  
  193. If you do not care about the functions mentioned above, you need not install OtherMenu AE Helper.  However, it uses only about 20K of RAM, and negligible execution time.
  194.  
  195.  
  196. Modal Dialogs    
  197.  
  198. Usually, you don't have much freedom of action when the front window is a modal dialog.  You know, the kind of window that has a border like this:
  199.  
  200. ﾂ 
  201.  
  202.  
  203.  
  204. You can窶冲 switch to another application, and you can窶冲 even switch to another window within the same application.  Yet, you can use OtherMenu to execute externals and FKEYs while a modal dialog is showing.  This freedom entails some risk, because the programmers who wrote your applications and other extensions probably didn窶冲 anticipate that you could do such a thing.  In fact my own programs Open-wide and Dialog View were only recently made compatible with showing a directory dialog on top of another directory dialog.
  205.  
  206. Certain externals (currently QuickAlias and QuickTrash) take control of the Other menu, so that you can窶冲 invoke other externals when they are running.
  207.  
  208.  
  209. Directory Dialogs    
  210.  
  211. Directory dialogs (Open and Save dialogs) are a special kind of modal dialog, and as such the previous section applies to them.  However, OtherMenu has another use within these dialogs:  You can use OtherMenu to select a folder to be displayed in the directory dialog, simply by pulling down the menu and releasing the mouse over the name of a folder.  In the case of Open dialogs, you can select a file (other than an external or FKEY) to make that file become selected in the Open dialog.  If OtherMenu fails to select the file you asked it to select, it will beep.  This can happen if you select a file that is not the right type for that Open dialog, or if the folder contains many files that start with the same letter.  The 窶徨ebound窶 feature in Super Boomerang or similar utilities may interfere with file selection, but not folder selection.
  212.  
  213.  
  214. Tips For Running OtherMenu    
  215.  
  216. In some cases, there may not be enough room on the menu bar for all of an application窶冱 menus plus the system menus.  If you have selected the 窶徇enu at left窶 setting, OtherMenu will be the first to disappear.  You may want to use a utility such as MICN or Cram Bar (freeware) or Menuette (shareware) to lessen menu-bar crowding.
  217.  
  218. OtherMenu launches most documents (i.e., items other than applications, desk accessories, FKEYs, and OtherMenu externals) by telling Finder to open the file.  When this happens, Finder will momentarily come to the foreground.  If there is not enough memory to open the file, Finder will display an alert box telling you about the problem.
  219.  
  220. Many of the functions of OtherMenu and its externals require that Finder be running.   OtherMenu can launch applications (including Finder itself), but not documents, when Finder is not running.
  221.  
  222. Occasionally it may be convenient for your menu to contain an alias to a folder or volume (perhaps a server) but not have a submenu hanging from it.  You can get this effect by changing the file type of the alias to something generic like '????'.  The File Info external could be used to do this.
  223.  
  224. DiskDoubler (version 4.0.1 and probably other versions) causes a crash if you try to open a directory dialog on top of another directory dialog.  There is a similar conflict with the General Controls control panel from System 7.5 and later, but I have included a patch to fix that.  See the chapter about that patch for more information.
  225.  
  226. QuikFloppy 1.0 conflicts with the 窶廴aintain volume items窶 feature.  Version 1.0.1 fixes the bug.
  227.  
  228. The startup animation in Turner Interactive窶冱 Iggy Cuckoo Clock conflicts with OtherMenu窶冱 recent files feature.  I have reported this to the authors of the Cuckoo Clock.
  229.  
  230. Compatibility problems have been reported with CP TrashBack, SpeedyFinder 1.5.4 (later versions may be OK), Menu Enabler 1.0, Escapade, and FWB CD-ROM Toolkit.
  231.  
  232.  
  233. Shareware Fee    
  234.  
  235. The shareware registration fee for OtherMenu is US$10 per user.  This software comes with a registration form and a registration application, each of which allows several forms of payment.
  236.  
  237. CompuServe users can register online.  GO SWREG; the ID is 1208.
  238.  
  239. The more payments I receive, the more likely I am to make further enhancements to OtherMenu.  If you have any feature requests, I will be much more likely to listen to you if you have paid.
  240.  
  241. James W. Walker
  242. 766 S. Nardo Ave. #C9
  243. Solana Beach, CA 92075
  244.  
  245.  
  246. Distribution    
  247.  
  248. OtherMenu may not be sold or offered for sale, or included with another software product offered for sale, except with the express written permission of the author.  The author窶冱 failure to give permission promptly should not be taken as consent.   Companies that distribute public domain/freeware/shareware software for profit are expressly prohibited from distributing OtherMenu.  This restriction does not apply to bulletin boards, commercial on-line services such as America Online, CompuServe and GEnie, and nonprofit Macintosh user groups which hold regularly scheduled public meetings.  However, OtherMenu must be distributed in full, as I released it, with no documentation or software missing.
  249.  
  250.  
  251. No warranty    
  252.  
  253. OtherMenu uses some undocumented techniques.  Use it at your own risk.  I will attempt to fix any bug that I can duplicate on my own machines, but will not buy other people窶冱 software for compatibility testing.
  254.  
  255.  
  256. Author窶冱 address    
  257.  
  258. I can be reached by e-mail at the following addresses.  For a regular mail address, see the Shareware section above.
  259.  
  260. Internet: jwwalker@kagi.com
  261. CompuServe: 76367,2271
  262. America Online: JWWalker
  263.  
  264. Also, drop by my Web site, <http:users.aol.com/jwwalker/>.  This will be the first place that new versions appear.
  265. ﾂ 
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274. Other software by this author    
  275.  
  276. Shareware:
  277.  
  278. 窶｢ Dialog View, which enhances the appearance of directory dialogs (size, font, icons)
  279. 窶｢ Manual Maker, a low-overhead standalone document kit.
  280. 窶｢ Carpetbag, which opens fonts, sounds, FKEYs, etc.
  281.  
  282. Freeware:
  283.  
  284. 窶｢ Text Capture FKEY, which lets you copy otherwise uncopyable text to the clipboard
  285. 窶｢ Text Editor Patches, which can add various features to applications
  286. 窶｢ PrintAid, next best thing to a spooling printer driver
  287. 窶｢ Alias Dragon, restore drag-and-drop function to cross-volume application aliases
  288. 窶｢ Reference Link, hot-links most any editor to THINK Reference
  289.  
  290.  
  291. Acknowledgements    
  292.  
  293. Thanks to Susan Lesch for helpful feedback, testing, and user interface assistance during the development of OtherMenu, and to Leonard Rosenthol for programming tips and assistance with some externals.  Thanks to others who beta tested, especially Mark Nagata and Bill Johnston.